빠른 시작

시작하기(회원가입)부터 첫 번째 문서 파싱(Parsing) API 호출 성공까지, 약 5분이면 완료됩니다.

사전 준비

robi DVLM 계정이 없다면 Step 1. 회원가입부터 시작합니다.

계정이 있다면 Step 3. API 키 발급으로 건너뜁니다.

Step 1. 시작하기(회원가입)

[robi DVLM 홈페이지]에 접속합니다.
[시작하기] 버튼을 클릭합니다.
이메일과 비밀번호를 입력해 가입하거나, Naver/Kakao/Google 계정으로 소셜 시작하기를 선택합니다.
이메일로 시작하기를 선택한 경우, 받은 편지함에서 인증 메일을 확인하고 인증코드를 입력해 [이메일 인증] 합니다.
인증 완료 후 로그인을 하여 Playground 화면으로 이동합니다.

회원 가입 완료 시 가입 즉시 매일 300 크레딧이 무료로 지급됩니다. 카드 등록이나 별도 결제는 필요 없습니다.

Step 2. Playground에서 먼저 체험하기

코드 없이, 브라우저에서 바로 결과를 확인할 수 있습니다. 직접 눈으로 확인하는 것이 가장 빠른 이해입니다.

좌측 메뉴에서 [Playground → 파싱] 을 클릭합니다.
[샘플 파일] 을 클릭하거나, 직접 PDF·이미지 파일을 드래그해서 올립니다.
[파싱 시작] 버튼을 클릭합니다.
잠시 후 결과 화면에서 문서가 텍스트·표 구조로 변환된 것을 확인합니다.

Step 3. API 키 발급

시스템에 자동화 연동을 원하는 경우 API 키가 필요합니다.

상단 메뉴에서 [API 키] 를 클릭합니다.
[+ 새 API 키 생성] 버튼을 클릭합니다.
키 이름을 입력합니다 (예: my-first-key). 나중에 구분하기 위한 별칭입니다.
[생성] 버튼을 클릭합니다.
화면에 표시된 API 키 전체를 즉시 복사해서 안전한 곳에 저장합니다.

API 키는 생성 직후 1회만 전체 값이 표시됩니다. 화면을 닫으면 이후 sk-****...****1234 형식으로 마스킹 처리되며, 전체 값은 재조회할 수 없습니다.

Step 4. 파싱 호출

YOUR_API_KEY_HERE를 발급받은 키로, test.png를 파싱할 파일 경로로 교체합니다.

curl -X POST "<https://playground-api.posicube.com/external/v1/parse-tasks>" \\
     -H "X-Api-Key: YOUR_API_KEY_HERE" \\
     -F "file=@test.png;type=image/png" \\
     -F "request={\\"contentFormat\\": \\"md\\", \\"encodingOption\\": false};type=application/json"

Step 5. 결과 확인

호출 성공 시 아래와 같은 응답이 반환됩니다.

{
  "code": "200",
  "message": "operation success",
  "data": {
    "id": 1,
    "taskId": "task-uuid-12345",
    "status": "COMPLETED",
    "output": "{\\"totalPages\\":3,\\"content\\":\\"# 파싱된 문서 내용\\\\n요청한 포맷(예: 마크다운)에 따라 문서의 텍스트가 추출됩니다.\\"}",
    "errorMessage": null,
    "startedAt": "2026-02-26T12:00:00",
    "completedAt": "2026-02-26T12:00:05"
  }
}

💡 API 호출 결과가 예상과 다를 때는 Playground에서 같은 파일로 먼저 테스트해 보세요.

주의사항

파일 크기는 최대 50MB까지 지원합니다.
무료 크레딧은 매일 300크레딧씩 자동 초기화됩니다. 당일 크레딧이 소진된 경우, 유료 크레딧 충전 기능(현재 준비 중)을 통해 추가 사용할 수 있습니다.

Step 1. 시작하기(회원가입)​

Step 2. Playground에서 먼저 체험하기​

Step 3. API 키 발급​

Step 4. 파싱 호출​

Step 5. 결과 확인​

주의사항​